Globe 1.5 of 01/11/89
---------------------

Revision History
----------------

Version 1.5 will convert the straight globe bitmaps to PICT resources.
The larger globe frames are significantly reduced in size due to the
run-length encoding inherent in PICTs.  Many tweaks were done over
the holidays with help from Bruce Leak and Darin Adler.  In no
particular order: imaging pixmaps to target window device, optimized
alignment, improved shading, addition of a palette and palette manager
support, and lots more.

Version 1.4 adds lots of new features and fixes a couple of nagging
bugs.  Most obvious is the inclusion of Larry's Rosentein's round
window WDEF.  The source for this nifty WDEF, written in Pascal,
can be obtained from Larry (lsr@apple.com) directly.
The nastiest bug had to do with slot interrupts on a Mac II in a
Juggler world.  I now do the right thing by stashing away a
copy of A5.
Window position is now saved along with all other user controls.
The adventurous programmer will note that I use a fairly simple
bounds checking routine for ensuring the windowÕs visibility onscreen.
If you happen to code the ultimate window bounds checker, please
let me know.
The option key display of the color table has been removed due to
popular demand.
Also due to popular demand, Globe now loads in the background when
used with Juggler.

Version 1.1 fixes a shading bug on Mac IIs in 1 bit/pixel mode.
I have heard complains with memory errors on a Mac II with screen
depths greater than 1.  Note that the memory requirement is greater
than globeWidth^2 / 8 * screenDepth * 32 which means the 256 x 256
globe will need more than 2mb of memory.  The memory preflighting and
usage is definitely not optimal.


General Info
------------
Globe is the classic spinning globe demo seen on Sun workstations.
It works on all Macintoshes with at least 512K of memory though it
looks best on a Mac II with 8 bits/pixel color.  The program consists
of the application Globe along with various data files containing
different sizes of the globe bitmaps.  The sizes range from 32 x 32 to
256 x 256.  Double clicking on one of the data files will bring up
a spinning globe in the desired size.  If you open the application
without selecting a data file, it will try to open a file titled
'GlobeFrames'.  Globe uses lots of memory; minimum around 300K and
much more if you are using a Mac II in one of the multibit screen modes.
The largest globe (256 x 256) uses over 2MB! when run at 8 bits/pixel.

I wrote a Globe for the Mac as an exercise in learning Color QuickDraw.
The goal was to write a decent demo completely in Pascal using
only Apple documented and approved techniques.  A bit of assembler
was neccessitated by the need to do VBL synchronization on the
Macintosh II.  There is also a bit of experimentation with Juggler.
Globe's heavy CPU usage makes it useful for investigating
QuickDraw (CopyBits) performance under different conditions such as
window placement and clipping.  The sadistic will no doubt change the
depth of the screen at runtime to watch QuickDraw sweat.

Comments and bug reports are welcomed.  Globe is free, if you pass it
on, please try to include this text.  If you didn't get the source code
(MPW 3.0 Pascal and a smidgen of Assembler) or all the frame files, I will
send them to you if you mail me a disk with some neat pd/shareware along
with a SASE.  

Enjoy,

Paul Mercer :)

Internet: 	pmercer@apple.com
AppleLink:	MERCER1

P.O. Box 160165
Cupertino, CA  95016-0165
